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ABOUT THIS CHAPTER 


This chapter describes the contents of the System file version 3.2 whose 
creation date is June 4, 1986. 


The System file, also known as the system resource file, contains standard 


resources that are shared by all applications, and are used by the Macintosh 
Toolbox and Operating System as well. This file can be modified by the user with 


the Installer and Font/DA Mover programs. 


Warning: You should not add resources to, or delete resources from, the 
system resource file directly. 


Note: Some of the resources in the system resource file are also contained 
in the 128K ROM; they're duplicated in the system resource file for 
compatibility with machines not equipped with the 128K ROM. Other 
resources are put in the system resource file because they are too 
large to be put in ROM. 


The system resource file contains the standard Macintosh packages and the 
resources they use (or own): 


« the List Manager Package ('PACK' resource 0), and the standard list 
definition procedure ('LDEF' resource 0) 

e the Disk Initialization Package ('PACK' resource 2), and code 
(resource type 'FMTR') used in formatting disks 

« the Standard File Package ('PACK' resource 3), and resources used to 


create its alerts and dialogs (resource types 'ALRT', 'DITL', and 'DLOG') 


the Floating-Point Arithmetic Package ('PACK' resource 4) 
the Transcendental Functions Package ('PACK' resource 5) 
the International Utilities Package ('PACK' resource 6) 

the Binary-Decimal Conversion Package ('PACK' resource 7) 


eoeee 


Certain device drivers (including desk accessories) and the resources they use 
(or own) are also found in the system resource file; these resources include: 


¢ the .PRINT driver ('DRVR' resource 2) that communicates between the 
Printing Manager and the printer 


¢ the .MPP and .ATP drivers ('DRVR' resources 9 and 10 respectively) used 


by AppleTalk 

« the Control Panel desk accessory ('DRVR' resource 15) and the bit maps 
(resource type 'bmap') and windows (resource type 'WIND') used in 
displaying its various options 


« the Chooser desk accessory ('DRVR' resource 16), and the dialogs, icons, 


list definition procedures, and strings (resource types 'DITL', 'DLOG', 
‘'ICON', and 'LDEF') that it uses (or owns) 


Other general resources contained in the system resource file include: 


e standard definition procedures for creating windows, menus, controls, 
lists, and so on 
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eoeee 


system fonts and font families (resource types 'FONT' and 'FOND') 
system icons 

code for patching bugs in ROM routines (resource type 'PTCH') 
initialization resources (described below) used during system startup 
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INITIALIZATION RESOURCES 


The system resource file contains initialization resources (resource type 
'INIT') used during system startup. A mechanism has been provided so that 
applications can supply code to be executed during system startup without adding 
resources of type 'INIT' to the system resource file. Instead of putting your 
code in the system resource file, you should create a separate file with a file 
type of 'INIT' (or for Chooser devices, file type 'RDEV'). 


A special initialization resource in the system resource file, 'INIT' resource 
31, searches the System Folder of the system startup volume for files of type 
'INIT' or 'RDEV'. When it finds one, it opens the file (with ResLoad set to 
FALSE) and uses GetIndResource (with ResLoad set to TRUE) to find all resources 
in that file of type 'INIT'. It calls each resource it finds. After calling the 
last resource, it closes the file, and continues searching for other files of 
type ‘INIT' or 'RDEV'. 


Warning: If you do not want your 'INIT' resources to be released, be sure 
to call the Resource Manager procedure DetachResource. 


Note: The order in which your 'INIT' resources are called depends on the 
order in which your 'INIT' and 'RDEV' files are opened, and on the 
order of the 'INIT' resources within these files; these orders are 
not predictable. 


Assembly-language note: The 'INIT' resource 31 saves all registers and 
places the handle to your 'INIT' resource in 
register AO. 


The System Startup Environment 


This section discusses the organization of the Macintosh Plus RAM at the time 
your 'INIT' files are loaded (see Figure 1); most the information presented here 
is useful only to assembly-language programmers. 
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Figure 1—Macintosh Plus RAM at System Startup 
Figure 1—Macintosh Plus RAM at System Startup 


The global variables, shown in parentheses, contain the addresses of the 
indicated areas. 


The application heap limit (stored in the global variable ApplLimit) is set to 
8K below the beginning of the boot stack to protect the stack. 


Static allocation off the address contained in the global variable BufPtr is 
useful when a large amount of space is needed which will never be deallocated 
(once space is allocated, it may not be deallocated unless no one has allocated 
space below). An 'INIT' resource may obtain permanent space by moving BufPtr 
down, but no further than the location of the boot blocks (MemTop/2 + 1K). (If 
it's necessary to allocate space below MemTop/2 + 1K, contact Developer 
Technical Support for details.) It may also use the application zone for 
temporary heap memory. 


Warning: An ‘INIT' resource that wants to grow the system heap should be 
aware that its associated resource map is open in the application 
heap at the time. 


To avoid their being deallocated when the application heap is initialized, 
vertical retrace tasks, AppleTalk listeners, and RAM-based drivers (and their 
storage) should be placed in the system heap or in statically allocated space. 
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Further Reference: 


Resource Manager 


Package Manager 
Technical Note #14, The INIT 31 Mechanism 
Technical Note #110, MPW: Writing Standalone Code 


END OF DOCUMENT 
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